home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Apple II Sample Code / Sample Code Notes (ProDOS) / SCN20DTSToolLib < prev    next >
Encoding:
Text File  |  1990-07-02  |  3.9 KB  |  95 lines  |  [TEXT/pdos]
  1. Apple II
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #20:    DTS Tools and Libraries
  7.  
  8. Version:    3.0                                                     June 1990
  9.  
  10. APW Components:    MPW Components:
  11.  
  12. DTS.Lib1.v1.0      DTS.Lib1.v1.0
  13. FMD.asm            FakeModalDialog.Aii
  14. FMD.h              FakeModalDialog.h
  15. FMDUserTool.asm    FakeModalDialog.usage
  16. E16.FMD            FakeModalTool
  17. M16.FMD            FMDUserTool.Aii
  18. OffScn.port.asm    E16.FMD
  19. PMUserTool.asm     M16.FMD
  20. PtrCheck.asm       OffScn.port.Aii
  21. PM2Rgn.root        PixMapTool
  22. Full.Build         PixMapTool.usage
  23. Build.DTS.lib      PMUserTool.Aii
  24. Build.FMDTool      PtrCheck.Aii
  25. Build.pMTool       PixelMap2Rgn.Aii.obj
  26. Build.Macros       Make.DTS.Lib1.v1.0
  27.                    Make.FMDTool
  28.                    Make.pMTool
  29.  
  30. FakeModalTool provides routines for modal and movable-modal dialog boxes, 
  31. while PixMapTool provides off-screen pixelmap support and allows conversion of 
  32. pixelmaps to regions.  Documentation for these routines is forthcoming in a 
  33. manual from APDA and will also be released in the next revision of Apple II 
  34. Sample Code in electronic format.
  35. _____________________________________________________________________________
  36.  
  37. Although the object code for PixMapTool is included as part of this
  38. sample, you must obtain a license to use it in commercial applications.
  39. You can license redistribution rights for PixMapTool by contacting Apple
  40. Software Licensing:
  41.  
  42.             Apple Software Licensing
  43.             Apple Computer, Inc.,
  44.             20525 Mariani Avenue, M/S 38-I
  45.             Cupertino, CA, 95014
  46.             (408) 974-4667
  47.             AppleLink:  SW.LICENSE
  48.  
  49. DTS Tools & Libraries contains the following collections of routines:
  50.  
  51. FakeModalDialog
  52.  
  53. FakeModalDialog is a flexible set of routines for dealing with modal dialog
  54. boxes (a modal dialog box is a window which remains in front of other
  55. application windows until the user dismisses it).
  56.  
  57. The FakeModalDialog routines are provided as assembly-language source code,
  58. in library form, and as a user tool set.  Sample Code #9, Lister, shows how
  59. to use FakeModalDialog from C.  By changing a #define in the file Lister.h,
  60. you can use either the library or the user tool set version (just use #define
  61. to define either _fmdLib_ or _fmdTool_, and fakeModalDialog.h takes care of
  62. generating calls to library routines or user tool functions).
  63.  
  64. For information on user tool sets, see Appendix A of Apple IIgs Toolbox
  65. Reference, Volume 1, and the Apple IIgs Technical Note #73, Using User Tool
  66. Sets.
  67.  
  68. There is a small assembly-language file that provides the user-tool wrapper
  69. around the fakeModalDialog routines (the wrapper is called FMDUserTool.aii
  70. under MPW IIgs and FMDUserTool.asm under APW).  The bulk of the wrapper is
  71. glue needed because tool set functions are called with two RTL addresses on
  72. the stack, while the real FakeModalDialog routines, written in C with
  73. Pascal-style calling conventions, require a single RTL address.
  74.  
  75. PixMapTool
  76.  
  77. The PixMapTool user tool set includes PixelMap2Rgn and the off-screen pixel
  78. map routines.  The user tool set wrapper, pmUserTool.aii, works very much
  79. like the user tool set wrapper in fakeModalDialog.
  80.  
  81. PtrCheck
  82.  
  83. The PtrCheck routines help detect when uninitialized auto pointer variables
  84. are used in APW C or MPW IIgs C.  See the source (PtrCheck.asm or
  85. PtrCheck.aii) for details.
  86.  
  87. APW 65816 assembly language users need APW v.1.0, APW Tools & Interfaces 
  88. v.1.1, and Apple IIGS System Software 5.0.2 or later.  Five APW command files, 
  89. Full.Build, Build.DTS.lib, Build.FMDTool, Build.PMTool, and Build.macros allow 
  90. you to perform complete or partial rebuilds of the tools.
  91.  
  92. MPW IIGS users need MPW v.3.0, MPW IIGS Tools v.1.1, and the MPW IIGS Assembler 
  93. v.1.0 or later.  Three MakeFiles, Make.DTS.Lib1.v1.0, Make.FMDTool, and 
  94. Make.PMTool allow you to perform complete or partial rebuilds of the tools.
  95.